home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / pbcll094.zip / PCBCALL.DOC < prev    next >
Text File  |  1992-01-19  |  5KB  |  131 lines
  1.  
  2.                              PCBCALL - version 1
  3.                             =====================
  4.                               By: Larry Schwenk
  5.  
  6.  
  7.  
  8.      If your like me, you hate reading documentation files as much as I
  9.      hate writing them.  So I'm going to get right to the point...
  10.  
  11.  
  12.      What is PCBCALL
  13.      ==============================
  14.  
  15.      This program is designed to work with the PCBoard BBS system.  It
  16.      will help sysops regain control of their CALLER log file.  This
  17.      version of PCBCALL can accomplish this by three methods:
  18.  
  19.      1 - keep only a specified number of lines
  20.  
  21.      2 - keep only a specified number of days
  22.  
  23.      3 - remove any users from the file, ie. since sysops normally enter
  24.          the system multiple times a day, an analysis of the log file
  25.          would be corrupted if the sysop's logs were not removed.
  26.  
  27.  
  28.  
  29.      - How PCBCALL works
  30.      ==============================
  31.  
  32.      The program must be passed a file name as a command line parameter.
  33.  
  34.      PCBCALL.EXE <file.cfg>
  35.  
  36.      where <file.cfg> is an ASCII file that contains the following:
  37.  
  38.      line 1:  full path and file name to caller log file
  39.      line 2:  full path and file name for the new caller log file
  40.      line 3:  total number of lines to keep
  41.      line 4:  total number of days to keep
  42.      line 5:  the first user name to be removed
  43.      line 6:  the second user name to be removed
  44.      line 7:  ...
  45.  
  46.      The smallest <file.cfg> must contain at least the first three
  47.      lines.
  48.      PCBCALL.DOC                                                 Page 2
  49.      ==================================================================
  50.  
  51.  
  52.      EXAMPLES:
  53.  
  54.      file1.cfg               file2.cfg               file3.cfg
  55.      ------------------      ------------------      ------------------
  56.      c:\pcb\main\caller      c:\pcb\main\caller      c:\pcb\main\caller
  57.      c:\pcb\main\newfile     c:\pcb\main\newfile     c:\pcb\main\newfile
  58.      4000                    0                       0
  59.                              14                      21
  60.                              larry schwenk
  61.                              john doe
  62.  
  63.      file1.cfg - would remove all but the last 4000 lines of the log
  64.                  file. It will not however split a user's entry, but
  65.                  will rather start the updated log at the point at which
  66.                  they logged off.
  67.  
  68.      file2.cfg - would remove all but the last 14 days of caller
  69.                  activity.  After all the 'old' entries are removed the
  70.                  program will then remove any log entry made by these
  71.                  two individuals.  They must be spelled EXACTLY, case is
  72.                  not your concern.  There can be as many names listed as
  73.                  you wish, but they must start on line 5 of the config
  74.                  file.
  75.  
  76.      file3.cfg - would remove all but the last 21 days of activity.
  77.  
  78.      If both a total number of lines to keep and a keep total number of
  79.      days is specified in the config file, ONLY the lines option will be
  80.      executed, the days will be ignored, however any names that follow
  81.      will still be removed if present.
  82.  
  83.      If names are to be removed it will be the final process to be
  84.      performed.
  85.  
  86.      If you want to keep just a total number of lines, but still remove
  87.      a couple of users AND want the users removed FIRST before the file
  88.      is cut 'down to size' then you can simply run the program twice
  89.      with two different config files.  The first with lines and days set
  90.      to 0 and the names listed, and the second file with just the lines
  91.      option.
  92.  
  93.      You may have line 2 exactly the same as line 1, which will simply
  94.      replace the old caller file.  However, this may cause some problems
  95.      with people using SHARE.EXE and having more than one node.
  96.      PCBCALL.DOC                                                 Page 3
  97.      ==================================================================
  98.  
  99.  
  100.      Author Support
  101.      ==============================
  102.  
  103.      You may have already noticed that there are no SHAREWARE notices
  104.      all over the place.  That is because I'm releasing this version of
  105.      the program as FREEWARE.  All I ask is that you let me know what
  106.      you think of it and offer your suggestions for future improvements. 
  107.      All updates to PCBCALL will be available on Salt Air BBS.
  108.  
  109.      If you have a problem there are several ways to contact me:
  110.  
  111.      Desert Highlands BBS  (816) 429-6245  HST/DS
  112.      Salt Air BBS
  113.      INTELEC Network (PCBoard conference)
  114.      CompuServe 71270,2053
  115.  
  116.      All written correspondence should be mailed to:
  117.  
  118.                        Larry Schwenk
  119.                        172 Cherry Street
  120.                        Warrensburg, MO 64093
  121.  
  122.  
  123.  
  124.      Legal Stuff
  125.      ==============================
  126.  
  127.      I've tested this program over and over again.  I have not found any
  128.      problems with it, but that does not mean that it is error free.  So
  129.      you are to use this program at your own risk.  As I can not be held
  130.      responsible for anything that might go wrong.
  131.